+7 (495) 542-0692

Руководство по API Query для авторов изображений и разработчиков

API Query Cliparto может принимать автоматические запросы в базу данных Cliparto с других веб-серверов или установленного локально программного обеспечения для получения актуальных данных по текущему балансу, числу скачиваний, числу изображений, статусу изображений и др.

Важно: Автоматические запросы разрешены только через API Query. Cliparto оставляет за собой право блокировать доступ к сайту в случае обнаружения парсинга иных страниц сайта.

Как это работает?

У нас очень простой алгоритм выдачи данных:
1. Ваш скрипт отправляет GET-запрос на наш сервер на адрес https://cliparto.com/apiq/
2. Наша система проверяет параметры запроса.
3. При отсутствии ошибок запрошенная информация выводится на странице запроса. В противном случае будет указан тип ошибки.

Параметры запроса

Каждый запрос должен содержать следующие параметры:

id - уникальный User ID (его можно найти на странице настроек пользователя)

q - тип запроса (список принимаемых типов запроса приведен в следующем разделе)

ext - дополнительный параметр (необязателен, зависит от типа запроса)

md5 - MD5-хэш запроса (в соответствии с RFC 1321 - The MD5 Message-Digest Algorithm)

Чтобы рассчитать MD5-хэш, Вам нужно скомпоновать строку, содержащую все параметры запроса (как показано ниже), и использовать специальную функцию в используемом языке программирования для генерации MD5-хэша.
Пример:

md5 ( id + q + ext + API Code )

Вы можете сгенерировать Ваш API-код на странице настроек пользователя.

Пример PHP-кода, чтобы сгенерировать MD5-хэш:

$string_to_hash=$id.$q.$ext.$api_code;
$md5=md5($string_to_hash);

Пример запроса:

https://cliparto.com/apiq/?id=176050&q=BalanceCurrent&md5=372aadd1bad841a7c898b57dbbecab44
id => 176050
q => BalanceCurrent
ext =>
API Code => 8zn2eBj90M0F
md5 => md5( 176050BalanceCurrent8zn2eBj90M0F ) => 372aadd1bad841a7c898b57dbbecab44

Типы запросов

qextДанные
BalanceCurrentn/aАктуальный баланс на аккаунте пользователя (USD)
EarningsTotaln/aЗаработанная сумма за все время (USD)
EarningsThisMonthn/aЗаработанная сумма за текущий месяц (USD)
EarningsPrevMonthn/aЗаработанная сумма за прошлый месяц (USD)
DownloadsTotaln/aЧисло скачиваний (продаж) за все время
DownloadsThisMonthn/aЧисло скачиваний (продаж) за текущий месяц
DownloadsPrevMonthn/aЧисло скачиваний (продаж) за прошлый месяц
DownloadsList1-100
по умолчанию - 10
Список последних скачиваний (продаж);
ext - количество выводимых записей (строк);
формат строки - дата; ID изображения; тип лицензии; размер изображения; заработок (USD); страна покупателя (ISO); поисковый запрос
ImagesTotaln/aОбщее число одобренных изображений
ImagesNewn/aОбщее число одобренных новых изображений в текущем месяце
ImagesNewPrevMonthn/aОбщее число одобренных новых изображений в прошлом месяце
ImageIDByFileNameНазвание файлаВозвращает ID изображения по названию файла при загрузке;
ext - исходное название файла при загрузке (без расширения)
ImageDataID изображенияИнформация об изображении по его ID;
ext - ID изображения;
Формат выдачи данных - статус изображения; название; просмотры; скачивания; заработок (USD); ID серии изображении; исходное название файла при загрузке
ProcessFilesFromFTPn/aОтправить все загруженные по FTP файлы в очередь обработки
SubmitToPendingn/aОправить все загруженные изображения на проверку
ReleasesListn/aСписок всех загруженных релизов;
Формат выдачи данных - ID; тип (1 - модели, 2 - собственности); название
AttachReleaseToImageRelease ID:Image IDПрикрепить релиз Relise ID к изображения Image ID

Ограничения

- Не более одного запроса в течение 20 секунд;
- Один и тот же запрос с одними и теми же параметрами не должен повторяться в течение одного часа

◢ Мой Cliparto
Есть аккаунт на Vector-Images.com?
Не нужно регистрироваться заново. Просто используйте свой логин и на Cliparto.

 

Помощь
Тел.: +7 (495) 542-0692
E-mail: help@cliparto.com
О фотобанке Правовая информация Партнерство
0.672